home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / satellit / pacdoc / alogdisp.asc < prev    next >
Text File  |  1991-04-15  |  5KB  |  96 lines
  1.  
  2.  
  3.  
  4. UoSAT/Microsat Activity Log Display Program
  5.  
  6. This program was written by H Price (NK6K) and J Ward (G0/K8KA). It compiles 
  7. using Microsoft C and the executable program will run on IBM PCs and 
  8. compatibles. If you modify this program for other machines and operating 
  9. systems, please send us a copy so that we can make it available to others.
  10.  
  11. The program alogdisp.c interprets the binary contents of activity log files 
  12. built by the file transfer server task on UO-14, AO-16 and LO-19. Each 
  13. satellite builds an activity log every day, and stores the login a file called 
  14. "ALyymmdd", where yymmdd is replaced by the year,month and day for which the 
  15. log was built. You download activity log files from the file server just as 
  16. you would any other file, or (preferably) receive them using the Broadcast 
  17. Protocol. Activity log files will have the PACSAT File Type 0x0c. Before you 
  18. can run alogdisp program on an activity log file, you must remove the PACSAT 
  19. File Header from the file using PHS or another file header utility.
  20.  
  21. The activity log file is a binary file containing variable-length structures 
  22. of two basic types. The first type includes a callsign and a variable amount 
  23. of data; this is the ALOG_2 structure defined in the file "alog.h". The second 
  24. type does not include a callsign; this is an ALOG_1 structure. Log entries 
  25. with callsigns included are used to log the beginning of a connected-mode 
  26. session or any event caused by a specific station but not related to a 
  27. connected-mode session,e.g. starting a broadcast. Log entries without 
  28. callsigns are used to log events within a connected-mode session and events 
  29. which occur automatically on the server.
  30.  
  31. For connected-mode sessions, the station's callsign is logged only once, at 
  32. the beginning of the session; this ALOG_START_SESSION type log entry also 
  33. contains the serial number related to that session.Subsequent log entries for 
  34. the session will not have callsigns, but can be identified by their 
  35. 'serial_no' variable.
  36.  
  37. All times printed by alogdisp.c are taken from the data file itself and 
  38. displayed as UTC.
  39.  
  40. This program now supports a callsign filter. You can filter out all log 
  41. entries relating to a particular callsign by placing that callsign after the 
  42. ALxxxxxx file name on the command line. Using the special file name 'admin' 
  43. will display only the automatic actions taken by the server task.
  44.  
  45.  
  46. WHAT TO LOOK FOR
  47.  
  48. You may just scan the log entries to find out who is active on the satellites 
  49. and how often. If you are having problems with your station, however, the 
  50. activity logs may help you locate the problem. If you're implementing your own 
  51. groundstation software, the activity logs can be an invaluable debugging tool.
  52.  
  53.  - BLOWOFFS 
  54.  
  55. A sure sign of problems in your groundstation is the "BLOWOFF" message with a 
  56. reason other than "inactivity timeout". (BLOWOFF with Inactivity Timeout is 
  57. what happens when you have LOS in the middle of a message transfer.) This 
  58. means that your groundstation software sent incorrect data to the satellite; 
  59. either the data didn't represent an valid FTL0 packet or it wasn't the packet 
  60. that the FTL0 protocol server was expecting at the time. If you are using a 
  61. new PACSAT groundstation program, this is possibly an indication of an error 
  62. in that program. If you are using an established PACSAT groundstation program, 
  63. the error is probably being caused by incorrect operation of the link between 
  64. your computer and your TNC. If you often get BLOWOFF during uploads, your 
  65. TNC/PC handshaking is incorrect. If you get BLOWOFF before you even begin 
  66. uploading, then there is something more basic wrong with the connections in 
  67. your station.
  68.  
  69.  - SELECT DONE
  70.  
  71. The SEL DONE entry can tell you how efficient you are at keeping up with 
  72. activity on the satellite. After the callsign is a field ddd/hh:mm:ss which 
  73. tells how many days, hours, minutes and seconds worth of files were searched 
  74. to make your selection. If your software is operating correctly, this will be 
  75. the same as the time since you last logged on to PACSAT and got a directory. 
  76. If the word "start" appears rather than a ddd/hh:mm:ss entry, then ALL the 
  77. files on the satellite were searched, which is inefficient and time consuming.
  78.  
  79. The len: entry tells how many bytes were in the selection equation, and the 
  80. selected: entry tells how many new files fit your selection.
  81.  
  82. The difference in time between the SELECT entry and the SEL DONE entry tells 
  83. how long it took for the satellite to search through new files for those you 
  84. wanted.
  85.  
  86. Example :
  87.  
  88. 02:33:00  SELECT     JA6FTL-2     
  89. 02:33:01  SEL DONE   JA6FTL-2             003/02:33:00 len:9 selected:14
  90.  
  91. In this case, JA6FTL-2 sent a 9-byte select equation, which took 1 second to 
  92. evaluate and resulted in the selection of 14 files. 3 days, 2 hours and 33 
  93. minutes worth of new files were searched.
  94.  
  95.  
  96. JWW/HEP